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/////////////////////////////////////////////////////////////////////§,' 



// 
/////// 
// 



SYSTEM: 

UNIT FILE NAME 
MODULE: 
AUTHORS : 
VERSION: 
DATE: 



// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 

// ABSTRACT: 
library file. 

// 

/ / REMARKS : 

// 

// COPYRIGHT (C) 2001 BY POLAR ELECTRO OY 

// 

////////////////////////////////////////////////////////////////////// 

/////// 

□ 



Polar HRMCom 
HRMCOM . H 

HRMCOM . DLL 
MEr / Polar Electro Oy 
1.2 

20.03.2001 

Main header file for Polar HRMCOM . DLL function 




// 
/////// 
// 
// 
// 
// 
// 
// 
// 
// 
// 



BOOLEAN VARIABLES 



Function library uses boolean variables as following: 



TRUE 
FALSE 



equals 1 
equals 0 



////////////////////////////////////////////////////////////////////// 
/////// 

////////////////////////////////////////////////////////////////////// 
/////// 
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// 

// FUNCTION CALLS 
// 

// 

// Definition of function calls: 

// 

// declspec (dllexport) BOOL CALLBACK fnHRMCom. . . 

// 

// can be replaced by 

// 

// BOOL fnHRMCom. . . 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 



////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// INITIALIZING DATA STRUCTURES 
// 

// 

// It is recommended to initialize all data structure always befo 

re 

usage by using 

// for example the functions memset or ZeroMemory. Uninitialized 

data structure 

// passed to functions may cause errors in communication. 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 



////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// POLAR S-SERIES MONITOR FEATURES 
// 

// 

// Feature S210 S410 S510 S610 

S710 S810 E200 E600 

// 



// Watch Settings 



x 
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X 


X 


X 




x4 


x4 


// 


Exercise Sets 


X 




X 


X 


X 


X 


xl 




x4 


x4 


// 


User Settings 


X 




X 


X 


x2 


x2 


x2 




x4 


x4 


// 


Reminders 










X 


X 


X 








// 


Exercise Profiles 










X 












/ / 


Monitor Bitmaps 










X 


X 


X 










Bikes 










X 




x3 








// 












// 


x = feature 


available 








// 


xl = Only one 


exercise 


set available 




// 


x2 = User settings extended with 


user name string 




// 


x3 = Also power output 


settings 






// 


x4 = Education models 1 


features 


are limited, see 


function 



definitions 
// 

// For more details about feature difference, refer to each 

function call definitions 

// and HR monitor user's manuals. Another good hint is also to us 

e 

Polar Precision 

// Performance SW 3.0 and it 1 s HR Monitor Connection. This softwa 

re 

products utilizes 

// HRMCom.dll function library. 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 



////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// POLAR CHARACTER SET 
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// 

// 

// The following characters are valid at text strings in settings 

■ 

// - Capital letters: ABCDEFGHI JKLMNOPQRSTUVWXYZ 

// - Small letters: abcdef ghi j klmnopqrstuvwxyz 

// - Numbers: 0123456789 

// - Special chars: -%/()*+.:? and space 

// 

// Unrecognized characters will be converted automatically to 

spaces . 

// The text strings have to be ended by zero character (NULL) . 

// Strings can be checked before sending by using function 

fnHRMCom_CheckPolarCharString 
// 

declspec (dllexport) BOOL CALLBACK f nHRMCom_CheckPolarCharString 



(LPTSTR) ; 
// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

// 

// DATE FORMAT 
// 

// 

// Date values are processed in yyyymmdd format: 

// yyyy year 4 digits 

// mm month 2 digits 

// dd day 2 digits 

// 

// For example: August 2nd 2000 => 20000802 

// December 24th 2003 => 

20031224 

// 

// NOTE: Leading zero with days and months is always obligatory. 

////////////////////////////////////////////////////////////////////// 

/////// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
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// 

// ERROR CHECKING 
// 

// 

// All input parameters will be checked before sending to heart 

rate monitor. 

// If any erratic values are determined, function call returns 

FALSE and does not 

// continue sending data to monitor. The latest error code can be 

checked by function: 

// iError = f nHRMCom_GetErrorCode (); 

// 

declspec (dllexport) int CALLBACK f nHRMCom_GetErrorCode 

(void) ; 
// 

// ## UNDER CONSTRUCTION ## // 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

////////////////////////////////////////////////////////////////////// 



// 

/////// 
// 

// POLAR HR MONITOR TYPES 
// 

// 

#define HRM_S210 

8 // Polar S210 
#define HRM_S410 

9 // Polar S410 
#define HRM_S510 

10 // Polar S510 
#define HRM_S610 

11 // Polar S610 
#def ine HRM_S710 

12 // Polar S710 
#define HRM_S810 

13 // Polar S810 
#define HRM_E200 

14 // Polar E200 Education HRM 
#define HRM_E600 

15 // Polar E600 Education HRM 
// 

// NOTE: Education HR monitors are regionally available. 
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// 

////////////////////////////////////////////////////////////////////// 
/////// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// MONITOR CONNECTION METHODS 
// 

// 

#define HRMCOM_CONNECTION_UPLINK 0 

#define HRMCOM CONNECTION IR 1 

// 

// Polar UpLink technology can be used only for transferring 

settings from computer 

// to Polar S-series HR monitor (one-way) . "Read" functions can b 

e 

called with 

// HRMCOM_CONNECTION_UPLINK as connection method, but method is 

automatically 

// changed to HRMCOM_CONNECTION_IR . Infrared conenction is 

automatically two-way, 

// this means all the settings etc. can be read and written. 

// 

// When infrared is used for writing or reading data to/from HR 

monitor, the communication 

// have to be started by using function 

fnHRMCom_StartIRCommunication. After calling this 

// function, all the other reading and writing functions can be 

used normally. To end 

// infrared communication, call function 

f nHRMCom_EndIRCommunication . 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// POLAR UPLINK WAVE FILES 

// 

// By default wave file (random name to Temp folder) will be 

created, played and deleted. 

// Wave file will be created automatically to Temp folder defined 
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at the Windows system. 

// The new wave file will be automatically named as HRMxxx.WAV, 

where xxx is a random number. 

// The playing of wav file do not allow cancellinq. 

// 

////////////////////////////////////////////////////////////////////// 

/////// 
□ 

//////////////////////// 
//////////////////////// 
// 

// LIBRARY VERSION DATA 

// 

//////////////////////// 
//////////////////////// 

// Get hrmcom library file version 

declspec (dllexport) int CALLBACK f nHRMCom_GetLibraryVersion 

(void) ; 

// Version 1.00 will be returned as 100 

//////////////////////// 
//////////////////////// 
// 

// GENERAL SETTINGS DATA 

// 

//////////////////////// 
//////////////////////// 



// 



The following data structure will be used with the most of the 



functions to give general information 

// about communication, for example are we using Polar UpLink or 

Infrared connection. 



typedef struct 
{ 

int iSize; 
size for version control 



using sizeof (STRUCTURE) 



// Structure 



// Get 



int 



iConnection; 
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HRMCOM__CONNECTION_UPLINK or HRMCOM__CONNECTION_IR 

// NOT 

E: 

Polar UpLink connection can be used only for writing information to HR 
monitor : 

int iMonitorlD; // Unique 

monitor ID, 0 = message to all monitors 

Monitor will accept the messages if monitor id to send is same as^ 
already 

// set 

by User settings or if message was meant for all monitors available. 

// Oth 

er 

ID numbers used mainly with IR communication 

TCHAR szWaveFile [MAX__PATH] ; // Wave file name, use NULL to 
create random file name 

// to 

Temp folder (MAX PATH = 2 60) 



EXCLUSION FLAGS 



// 
// 



BOOL bNoCreateWave; // Don 1 1 create wave file at 

all, this allows testing of values in the data structure 

BOOL bNoPlayWave; // Don't play created Polar 

UpLink WAV file 

BOOL bNoDeleteWave; // Don't delete created Polar 

UpLink WAV file after it have been played 



A 

FILE MANAGEMENT 



// DAT 



// 

BOOL bLoadFromDataFile; // Load information from binat 

y 

data file, file name have to be at szWaveFile 

// If 

trying to load the data file with not the same data as data structure 
specified in call, all the calling functions will return FALSE 

// Whe 
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n 



file will be loaded, other actions (create, play, delete wave) are not 



done . 

loaded file includes incorrect data, default values will be set 
automatically . 



// If 



BOOL bSaveAsDataFile; // Save information to binary 

data file, file name have to be at szWaveFile 

// Whe 



n 



file will be saved, other actions (create, play, delete wave) are not 
done. 



CONNECTION DIALOG 



to 

user 



BOOL bConnectionDlg; 



HWND hOwnerWnd; 



// 
// 

// Usage of connection dialog 



// Owner window handle 



to connection dialog 



connection dialog has been selected to be shown, owner window 

handle have to be specified. If not, dialog won 1 1 be shown and 
connection fails. 

connection dialog is not in use, this parameter is ingnored. 



// If 



// 



// If 



TCHAR szDlgMsg[50] ; 



/ / Connection dialog message t 



user, max 50 characters 

// If 

message text is not specified, default English texts will be used 

// If 

connection dialog is not in use, this parameter is ingnored. 



PARAMETERS 



// MIS 



// 



BOOL bFixErrors; 
can be fixed automatically and error messages 
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not returned in normal cases. 

int iParam; 
reserved for future usage, use zero 

long IParam; 
for future usage, use zero 

} POLAR SSET GENERAL; 



// are 



// Parameter 
// Parameter reserved 



//////////////////////// 
//////////////////////// 

// 

// WATCH SETTINGS 

// 

//////////////////////// 
//////////////////////// 

// All Polar S-series HR monitors do have two independent time 

zones. The active time zone 

// can be selected with iActiveTime. 



typedef struct 
{ 

int iSize; 
size for version control 



using sizeof (STRUCTURE) 



// Structure 



// Get 



int iTimel; // Time in 

seconds from midnight (0:00:00), max 23:59:59 = 86399 sec 

// If 

iTimel = -1, current system time is automatically set to iTimel 

int iTime2; // Time in 

seconds from midnight (0:00:00), max 23:59:59 = 86399 sec 

// If 

iTime2 = -1, current system time is automatically set to iTime2 

// Onl 

y 

full hours and minutes are valid, seconds will be set to zero 



int 



2h 

mode 



iTimelHourMode; 



// 0 = 24h mode, 1=1 
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int iTime2HourMode; // 0 = 24h mode, 1=1 

2h 

mode 

int iActiveTime; // 0 = timel active, 1 

time2 active 

int iDate; // Date in 

format yyyymmdd, Jan 1 2000 - Dec 31 2099 

// If 

iDate = -1, current system date is automatically set to iDate 

BOOL bAlarmEnabled; // FALSE = off, TRUE = on 

in t iAlarmTime; // Time in 

seconds from midnight (0:00:00), max 23:59:59 = 86399 sec 

// Onl 

y 

full hours and minutes are valid, seconds will be set to zero 
} POLAR_SSET_WATCH ; 

declspec (dllexport) void CALLBACK f nHRMCom_ResetWatchSett ings 



(POLAR_SSET_WATCH*) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendWat chSettings 

( POLAR_SSET_GENERAL* , POLAR_SSET_WATCH* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadWatchSett ings 

( POLAR_SSET_GENERAL* , POLAR_SSET_WATCH* ) ; 

// NOTE: Education HR monitors E200 and E600 do have only one time 
(iTimel) and no alarm available. 

// Set iTime2 to the same as iTimel, hour mode should be the same for 
both times. 

// Alarm time should be zero and alarm should be not enabled. 

□ 

//////////////////////// 
//////////////////////// 
// 

// EXERCISE SET 
// 

//////////////////////// 
//////////////////////// 

// Exercise Set information will be send to monitor one set at a time 
// Exercise Set can be set as an active set to monitor (i.e. set will 
be 

shown 

// as the first set when next time starting exercise) . 
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typedef struct 
{ 

in t iSize; // Structure 

size for version control 

// Get 

using sizeof (STRUCTURE) 

int iSetNumber ; // Exercise se 

t 

number: 0, 1, 2, 3, 4, 5. 

// Set 

number 0 can be used only for setting "Basic Set" active. 

// Set 

s 

2-5 are not available for all monitors (see Polar S-series Monitor 
Features) . 

BOOL bActiveSet; // will this set to be 

set as an active set in monitor? TRUE/FALSE 

TCHAR szName[8]; // Exercise set name 

(see Polar Character Set) 

// 

String can be checked using function f nHRMCom_CheckPolarCharString 

// Max 

number of characters is 7 + ending zero 

// 

"BasicUse" name is permanent for S610, S710 and S810, it can't be 
modified. 

// Timers 

BOOL bTimerlEnabled; // Timer 1 enabled TRUE/FALSE 

int iTimerl; // Timer 1 val 

ue 

in seconds, max 99 min 59 sec (= 5999 sec) 

BOOL bTimer2Enabled; // Timer 2 enabled TRUE/FALSE 

int iTimer2; // Timer 2 val 

ue 

in seconds, max 99 min 59 sec 

// Tim 

er 

2 used as interval timer, if intervals enabled. 

BOOL bTimer3Enabled; // Timer 3 enabled TRUE/FALSE 

in t iTimer3; // Timer 3 val 

ue 
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in seconds, max 99 min 59 sec 
// HR Limits 

BOOL bHRLimitlEnabled; // HR Limits 1 enabled 

int iHRLimitlUpper; // HR Limit 1 upper 

value 30 - 24 0 bpm 

int iHRLimitlLower; // HR Limit 1 lower 

value 30 - 240 bpm (must be less than upper limit) 

BOOL bHRLimit2Enabled; // HR Limits 2 enabled 

int iHRLimit2Upper; // HR Limit 2 upper 

value 30 - 240 bpm 

in t iHRLimit2Lower; // HR Limit 2 lower 

value 30 - 240 bpm (must be less than upper limit) 

BOOL bHRLimit3Enabled; // HR Limits 3 enabled 

int iHRLimit3Upper; // HR Limit 3 upper 

value 30 - 240 bpm 

in t iHRLimit3Lower; // HR Limit 3 lower 

value 30 - 240 bpm (must be less than upper limit) 

BOOL bMaxHRInUse; // Are HR limit values in 

percentage of maximum HR given in iMaxHR variable? 

// If 

TRUE, all HR limit values are used as percentage values (50 - 100%) 

int iMaxHR; // Maximum HR 

value to be used for calculation of HR limit values. 

// HR 

value in bpm, 100 - 240 bpm 

// Intervals 

BOOL blntervalsEnabled; // TRUE/FALSE 

int ilntervalType; // 0 = manual, 1 = tim 

er 

(use Timer2) , 2 = HR, 

// 3 = 

distance (distance only with cycling models) 

in t ilntervalCount; // The number of 

intervals, 0-30 (0 = unlimited) 

in t ilntervalEndHR; // Interval ending HR 

bpm 10 - 240 bpm 

int ilntervalDistKm; // The distance of 

interval in 0.1 km (max 99.9 km) 

// If 

monitor does not support cycling features, this value is ignored 

int ilntervalDistMiles; // The distance of 

interval in 0.1 miles (max 99.9 miles) 

// If 

monitor does not support cycling features, this value is ignored 
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// If 

both distance values are specified, km value takes precedence. 

// Recovery 

BOOL bRecoveryEnabled; // TRUE/FALSE 

int iRecoveryType; // 0 = timer recovery, 



1 

= HR recovery 



// 2 = 



distance recovery (distance only with cycling models) 

int iRecoveryTime; // Recovery time in 

seconds, max 99 min 59 sec (max 5999 sec) 

int iRecoveryHR; // recovery HR value 1 

0 

- 240 bpm 

in t iRecoveryDistKm; // The distance of 

recovery in 0.1 km (max 99.9 km) 

// If 

monitor does not support cycling features, this value is ignored 

in t iRecoveryDistMiles; // The distance of 

recovery in 0.1 miles (max 99.9 miles) 

// If 

monitor does not support cycling features, this value is ignored 

// If 

both distance values are specified, km value takes precedence. 
} POLAR_SSET_EXERC I SESET ; 

declspec (dllexport) void CALLBACK fnHRMCom ResetExerciseSet 



(int, POLAR_SSET_EXERCISESET*, int, int); // . iExerciseType, 

iMonitor 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendExerciseSet 

( POLAR_SSET__GENERAL* , POLAR_SSET_EXERCISESET* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadExerciseSet 

( POLAR_SSET_GENERAL* , int, POLAR_SSET_EXERCISESET* ) ; 

// Integer value at resetting and reading functions include exe s 

et 

number (1-5) 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

// NOTE: Education HR monitors E200 and E600 do have only one Exercise 
Set, iSetNumber should be 1 (one) . 

// E200 and E600 HR monitors do have the following features: 
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// - Timers 1 and 2 

// - HR Limits 1 

// ~ Recovery calculation (type timer always) 

// Other exercise settings should be set to default values 

□ 



//////////////////////// 
//////////////////////// 
// 

// USER SETTINGS 

// 

//////////////////////// 
//////////////////////// 



User settings include both information about the person and th 



// 
e 

usage of monitor features. 

// All the settings are not available in all Polar S-serie monito 

r, 

see more details 

// from monitor specifications. If any data send to monitor is no 

supported, it will 

// be ignored automatically. 



typedef struct 
{ 

int iSize; 
size for version control 



using sizeof (STRUCTURE) 

// Information about user 
int iDateOfBirth; 

format yyyymmdd, Jan 1 1921 - Dec 31 2020 

int iActivityLevel ; 

low, 1 = moderate, 2 = high, 3 = top 

int iMaxHR; 

rt 

rate value 100 - 240 bpm 

int iV02max; 

e 

10 - 95 mmol/l/kg 

int iUserSex; 

■ 

0 = male, 1 = female 



// Structure 



// Get 



// Date of birth i 



n 



// Activity level: 0 = 



/ / Maximum hea 



// V02max val 



u 



// Sex of user 
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int iWeightKg; // Weight in 

kilograms: 0, 20 - 199 kg 

int iWeightLbs; // Weight in 

pounds: 0, 44 - 499 lbs 

both weight values are specified, kg value takes precedence. 

int iHeightCm; // Height in 

centimeters, 0, 90 - 211 cm 

int iHeightFt; // Height in 

feet: 0, 3 - 7 ft 

int iHeightlnches; // Height in inches: 0 



11 inches 



both height values are specified, cm value takes precedence 



// If 



TCHAR szName[8]; 



Character Set) 



// User name (see Pola 



// 



String can be checked using function f nHRMCom_CheckPolarCharSt ring 

// Max 



number of characters is 7 + ending zero 

monitor does not support user name, this value is ignored 



// If 



// Monitor Features and Functions 

int iMonitorlD; 
number (for example player number) 0-99 

BOOL bOwnCal; 
enabled TRUE/FALSE 

BOOL bHRMaxP; 



enabled TRUE/FALSE 

BOOL bOwnlndex; 

n 

enabled TRUE/FALSE 

BOOL bAltimeter; 
TRUE/FALSE, available only for S710 

BOOL bButtonSound; 
TRUE/FALSE 

BOOL bOptionsLock; 
TRUE/FALSE 

BOOL bHelp; 

on 

enabled TRUE/FALSE 

BOOL bUS Units; 



// Monitor ID 
// OwnCal calculation 
// HRmax-p calculation 



// Own Index calculatio 



// Altimeter enabled 



/ / Button sounds enabled 

/ / Options mode lock enabled 

// Feature help functi 



// Measurement units : 
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FALSE = EURO units, TRUE = US units 

int iSamplingRate; // 0 = 5s, 1 = 15s, 2 

60s, 3 = R-R intervals 

// 

Sampling rate selection is available only with S610, S710 and S810 

// R-R 

intervals recording is available only with S810 

// 

Monitor S210 do not have sampling rate selection 

// 

Monitors S410 and S510 have always dynamic sampling rate 

int iHeartTouch; // Usage of Wireless 

Button trigger (heart touch feature) 

// 0 = 

normal, 1 = lap, 2 = change display and limits 

// 

Wireless button action selection is available with S610, S710 and S810 

int iRLXBaseLine; // Relaxation base lin 

e 

only for S810, 4 - 150 mseconds 

BOOL bOnlineRecording; // Online recording enabled 

TRUE/FALSE, S810 only 

} POLAR_SSET_USER; 

declspec (dllexport) void CALLBACK f nHRMCom_ResetUserSett ings 

(POLAR_SSET_USER *); 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendUserSettings 

( POLAR_SSET_GENERAL* , POLAR_SSET_USER* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadUserSett ings 

( POLAR_SSET_GENERAL* , POLAR_SSET_USER* ) ; 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

// NOTE: Education HR monitors E200 and E600 do have only the followin 

g 

features: 

// Options Lock, User Name, Monitor ID, Sampling Rate (E600 only) 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// V02max and HRmax-p values are used in OwnCal calories calculation 
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// and those values can be updated as follows: 
// 

// PC using UpLink/IR > 

// Ownlndex from FitTest --> UserSet in Monitor > OwnCal 

calculation in monitor 

// Manually set > 

// 

////////////////////////////////////////////////////////////////////// 
7/ 

/////// 
□ 

//////////////////////// 
//////////////////////// 
// 

// REMINDER 
// 

//////////////////////// 
//////////////////////// 

// Reminders are available with S610, S710 and S810 heart rate 

monitors. There are 

// 7 reminder "slots" available in each HR monitor and those can 

be 

modified only, by using 

// computer. Each reminder can be individually set to be activate 

d 

at selected date & time. 

// One reminder at time can be sent to HR monitor, select reminde 

r 

"slot" to be updated by iNumber. 

// Reminder can be repeated automatically hourly, daily, monthly, 

weekly, monthly and yearly. 

// An exercise (ExeSet / ExeProfile) can be set to be active afte 

r 

reminder has alarmed. 

typedef struct 
{ 

int iSize; // Structure 

size for version control 

// Get 

using sizeof (STRUCTURE) 

int iNumber; // Number of 
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reminder, 0-6 

BOOL bActive; // Reminder activated 

TRUE/FALSE 

int iDate; // Date of 

reminder in format yyyymmdd, Jan 1 2000 - Dec 31 2020 

int iTime; // Time in 

seconds from midnight (0:00:00), max 23:59:59 = 86399 sec 

// Onl 

y 

full hours and minutes are valid, seconds will be set to zero 

int iRepeat; // Repetition 

of 

reminder. 0 = Off, 1 = Hourly, 

// 2 = 

Daily, 3 = Weekly, 4 = Monthly, 5 = Yearly 

int iExercise; // S810: 

Exercise Profile to be set as default profile after reminder alarm 

// 0 = 

Off, 1 = BasicUse, 2-8 Profile Number (remember to update also 
exercise profiles ) 

// S61 

0 

& S710: Exercise Set to be set as default profile after reminder alarm 

// 0 = 

Off, 1 = BasicUse, 2-7 ExeSet Number (remember to update also 
exercise sets ) 

TCHAR szText[8]; // Reminder Text (see 

Polar Character Set) 

// 

String can be checked using function f nHRMCom_CheckPolarCharString 

// Max 

number of characters is 7 + ending zero 
} POLAR_S S ET_REM I N DE R ; 

declspec (dllexport) void CALLBACK f nHRMCom_ResetReminder 

( int , POLAR_SSET_REMINDER* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMComjSendReminder 

( POLAR_SSET_GENERAL* , POLAR_SSET_REMINDER* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadReminder 

( POLARIS SET_GENERAL*, int, POLAR_SSET_REMINDER* ) ; 
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// Integer value at resetting and reading functions include 

reminder number (0 - 6) 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

□ 

//////////////////////// 
//////////////////////// 

// 

// BIKES 
// 

//////////////////////// 
//////////////////////// 

// Bike information is available only with S510 and S710. Bike's 

power settings will 

// be transferred only to Polar S710 HR monitor. 

typedef struct 
{ 

// Bike Information 

TCHAR szBikeID[5]; // Bike ID (name) (see Polar 

Character Set) 

// 

String can be checked using function f nHRMCom_CheckPolarCharString 

// Max 

number of characters is 4 + ending zero 

int iWheelSize; // Wheel size 

in 

millimeters (1000 - 3000 mm) 

BOOL bAutoStart; // i s autostart featur 

e 

in use TRUE/ FALSE 

BOOL bSensorSpeed; // Speed sensor in use 

TRUE/FALSE. This flag is not in use, speed sensor is always in use. 

BOOL bSensorCadence; // Cadence sensor in use 

TRUE/FALSE 

BOOL bSensorPower ; // Power sensor in use 

TRUE/FALSE 

// Pow 

er 

sensor is available only with Polar S710 HR monitor 

// If 

monitor does not support power sensor, this value is ignored 
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// Power Sensor Settings 

int iChainMass; // Weight of 

chain in grams (200 - 400 g) 

int iChainLength; // Length of chain in 

mm 

(1000 - 2000 mm) 

int iChainWank; // The length 

of 

vibrating part (span) chain in mm (300 - 600 mm) 

} P0LAR_B I KE_I N FO ; 

typedef struct 
{ 

int iSize; // Structure 

size for version control 

// Get 

using sizeof (STRUCTURE) 

int iBikelnUse; // Which bike 

has been selected to be in use right now? 

// 0 = 



Bikel, 1 = Bike2, 2 = None (no cycling features in use) 

Bikel is in use, some cycling sensor (speed, cadence or 

power) have to be in use. 

POLAR BIKE INFO Bike[2]; 



// If 
// 



} POL AR_S S E T_B IKES; 

declspec (dllexport) void CALLBACK f nHRMComJResetBikeSettings 

(POLAR_SSET_BIKES*) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom__SendBikesSett ings 

( POLAR_SSET_GENERAL* , POLAR_SSET_BIKES* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadBikesSettings 

( POLAR_SSET_GENERAL* , POLAR_SSET_BIKES* ) ; 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

□ 

//////////////////////// 
//////////////////////// 
// 
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// EXERCISE PROFILE 
// 

//////////////////////// 
//////////////////////// 

typedef struct 
{ 

BOOL bPhaseEnabled; 
enabled? TRUE/FALSE 

// HR Limits 

BOOL bHRLimitEnabled; 
int iHRLimit Upper; 



// Has exercise phase been 



// HR Limits enabled 

// HR Limit upper valu 



e 

30 
e 

30 



240 bpm 
int 



iHRLimit Lower; 



// HR Limit lower valu 



- 240 bpm (must be less than upper limit) 



// Interval period 

BOOL blntervalsEnabled; 
enabled? TRUE/FALSE 

int ilntervalType ; 

timer, 2 = End HR 

int ilntervalCount ; 

intervals, 0-30 (0 = unlimited) 

int ilntervalTimer ; 

seconds, max 99 min 59 sec (= 5999 sec) 

int ilntervalEndHR; 
bpm 10 - 240 bpm 



// Recovery period 
BOOL bReco ve r y Enabled; 
enabled ? TRUE/FALSE 

int iRecoveryType; 

1 

= HR recovery 

int iRecoveryTime ; 

seconds, max 99 min 59 sec (max 5999 sec) 

int iRecoveryHR; 
0 

- 24 0 bpm 



// Is entire work period 



// 0 = manual, 1 = 

// The number of 

// Timer value in 

// Interval ending HR 



// Is entire recovery period 

// 0 = timer recovery, 

// Recovery time in 
// recovery HR value 1 



} POLAR__EXEPHASE; 
typedef struct 



{ 



int 



i S i z e ; 



// Structure 
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size for version control 

// Get 

using sizeof (STRUCTURE) 

int iNumber; // Exercise 

profile number, 1-7 

BOOL bActiveProf ile; " , // Will this profile to be set 

as an active set in monitor? TRUE/FALSE 

TCHAR szName[8]; // Exercise profile na 

me 

(see Polar Character Set) 

// 

String can be checked using function f nHRMCom_CheckPolarCharString 

// Max 

number of characters is 7 + ending zero 

BOOL bMaxHRInUse; // Are HR limit values in 

percentage of maximum HR given in iMaxHR variable? 

// If 

TRUE, all HR limit values are used as percentage values (50 - 100%) 

int iMaxHR; // Maximum HR 

value to be used for calculation of HR limit values. 

// HR 

value in bpm, 100 - 240 bpm 

POLAR_EXE PHASE Phase[6]; // One exercise profile includ 

es 

6 exercise phases 

// Eac 

h 

phase should be defined as POLAR_EXE PHASE structure 
} POLAR_SSET_EXERCISEPROFILE; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ResetExerciseProf ile 

(int, POLAR_SSET_EXERCISEPROFILE*, int) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendExerciseProf ile 

( POLAR_SSET_GENERAL* , POLAR_SSET_EXERCISEPROFILE* ) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadExerciseProf ile 

( POLAR_SSET_GENERAL* , int , POLAR_SSET_EXERCISEPROFILE* ) ; 

// NOTE: Exercise profiles are available only with Polar S810 HR 

monitor . 

// Integer value at resetting and reading functions include Exe 

Profile number (1-7) 
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// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

□ 

//////////////////////// 
//////////////////////// 
// 

// MONITOR BITMAP LOGO 
// 

//////////////////////// 
//////////////////////// 

// NOTE: Monitor bitmap logos are available with Polar S610, S71 

r 

S810, E200 and E600 HR monitors. 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendBitmap 

(POLAR_SSET_GENERAL*, int*) ; 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadBitmap 

(POLAR_SSET__GENERAL*, int*) ; 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

// Example: Each pixel column in one integer value => int 

iBitmapPixelCol [47] ; 

// First pixel in the bottom is 2*0, second 2*1, 

third 2*2, etc. 

// If three pixels in bottom are ON => 

iBitmapPixelCol [iColumn] = 7 (1+2+4) 

// If entire column is ON => 

iBitmapPixelCol [iColumn] = 255 (1+2+4+8+16+32+64+128) 

// Send to monitor f nHRMCom_SendBitmap 

(^iBitmapPixelCol [0] ) ; 

□ 

//////////////////////// 
//////////////////////// 
// 

// SET HR MONITOR TO WATCH MODE 
// 

//////////////////////// 
//////////////////////// 
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// Sets monitor to watch mode, monitor do not accept other 

// messages, until it has been switched back to Connect mode. 

declspec (dllexport) BOOL CALLBACK f nHRMCom_SendMonitorToWatchMode 

(POLAR_SSET_GENERAL*) ; 

// If sending was succesfull, function returns TRUE, otherwise 

FALSE 

□ 

//////////////////////// 
//////////////////////// 
// 

// FACTORY DEFAULTS 
// 

//////////////////////// 
//////////////////////// 

// Sets monitor factory defaults, resets all monitor data includi 

ng 

EEPROM memory. Use very carefully! ! ! 

// Setting factory defaults is not meant for normal software usag 

e, 

only for service software products. 

// When settings factory defaults, confirmation of the operation 

should be asked always. 

declspec (dllexport) BOOL CALLBACK fnHRMCom SendFactoryDef aultComman 

d ~ 

( POLAR_SSET__GENERAL* ) ; 
□ 

//////////////////////// 
//////////////////////// 
// 

// DELETING EXERCISE FILES FROM HR MONITOR 
// 

//////////////////////// 
//////////////////////// 

// Exercise files can be deleted by using the following function 

call. Files can be deleted 

// from Polar S610, S710, S810 and E600 HR monitors. 

// 

// NOTE: The first version of Polar S610 ( DataVersion=l ) can't 

handle deleting one exercise 
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// file correctly, all exercise files can still be deleted. 

// 

// NOTE: The first version of Polar S810 ( DataVersion=3 ) can't 

handle deleting all exercise 

// files correctly, one exercise file can still be deleted. 

// 

// Check monitor type and data version before sending file delete 

message to monitor! 
// 

// Give exercise number as int parameter 

should be deleted, use int parameter -1 



(0 - n) , if all files 



declspec (dllexport) BOOL CALLBACK fnHRMCom SendFileDeleteCommand 



(POLAR SSET GENERAL*, int); 



□ 



/////////////////////// 

//////////////////////// 

// 

// INFRARED COMMUNICATION FUNCTIONS 
// 

//////////////////////// 
//////////////////////// 

//////////////////////// 
// 

// MONITOR INFO 
// 

//////////////////////// 



typedef struct 
{ 

int iSize; 
Structure size for version control 



// 



int 

in 

use: HRM_S610, 

int 

data version 



iMonitorlnUse; 

HRM_S710, HRM_S810 or HRM_E600 

iDat aversion; 



// HR monitor 



// HR monitor 



int 



iTotalFiles; 



// Total count 



of all files inside HR monitor 

int i-FreeMemorylnBytes ; 



// Free memory 
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inside HR monitor (in bytes) 

int iTotalMemorylnBytes ; 

HR monitor (in bytes) 



// Total memory inside 



BOOL 

or 

TRUE / FALSE 



bLowBattery; 



// Low battery indicat 



} POLARIS S ETYMON I TOR INFO; 

declspec (dllexport) BOOL CALLBACK fnHRMCom ReadMonitor Inf o 



(POLAR_SSET_GENERAL*, POLARIS S ET_MON I TORI N FO * ) ; 
□ 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// f nHRMCom__Reset IRCommunication 
// 

// Call in the startup of software to reset all the communication 

parameters . 
// 

// Parameters: 

// int iParam Reserved in future usage, use 0 (zero) 

* 

// 

// Return value: 

// TRUE - Resetting made succesfully 

/ / FALSE - Resetting was not made because of 

communication is already running. 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ResetIRCommunication 

(int); 

□ 



////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 
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fnHRMCom Start IRCommunication 



Call to open communication port and start IR communication. 



Parameters : 
int iParam 



Parameter for connection settings (whe 



See "Infrared communication 



// 
// 
// 
// 
// 
// 
n 

used multiple params, use OR) 
// 

parameters" 
// 

// LPTSTR tcPort Communication port name, for example "C0M1 : " o 

r 

"COM2 : " 

/ / Remember to use to use colon : 

at the end of port name 
// 

/ / Return value : 

// BOOL bStartOK 

// TRUE 
succesf ully 
// FALSE 
following possible errors: 
// 

already been started and it is running 



// 



already reserved for some other device 



// 



from 16-bit program. A 32-bit DLL cannot 



// 



- Starting of communication made 

- Problems encountered, check the 

* Communication has 

* Communication port 

* Maybe call was made 
create an additional 



thread when that DLL is being called by 

// 

// 



a 16 -bit program. 



////////////////////////////////////////////////////////////////////// 
// 

/////// 

declspec (dllexport) BOOL CALLBACK fnHRMCom Start IRCommunication 



(int, LPTSTR) ; 



□ 



/ / Infrared communication parameters 

#define HRMCOM_PARAM_INTERNALIR 

1 

IR port (Win95 only) 



// Use interna 
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#define HRMCOM_PARAM_KEEPCONNECT 2 
r 

in Connect mode during connection 

#define HRMCOM_PARAM_FILTERHRDATA 4 
averaged HR data (sampling rate 5 or 15 seconds) 



// Keep monito 



// Filter 



// (not yet implemented) 
#define HRMCOM_PARAM_DIRECT_USB 
ge 

#define HRMCOM_PARAM_VIRTUALCOMPORT 
usage 

#define HRMCOM_PARAM_DUMP FRAMES 
c:\frames.txt or c:\all.txt text files 



16 



64 



// Direct USB port usa 



32 // Virtual COM port 



// Dump frames to 



// Dumping can be used for data error detection 
#define H RMCOM_ P ARAM_ON LINE 
recording mode (Polar S810 only) 

□ 



128 



// Online 



f nHRMCom_EndIRCommunication 

Call to close communication port and end IR communication. 



////////////////////////////////////////////////////////////////////// 

/////// 
// 
// 
// 
// 
// 
// 
// 

(zero) . 
// 
// 
// 
// 



Parameters : 
int iParam 



- Reserved in future usage, use 0 



- Ending of communication made 

- Problems with ending of communicatio 



Return value: 
BOOL bEndOK 
TRUE 
succesf ully 
// FALSE 
n 

// 

////////////////////////////////////////////////////////////////////// 
/////// 

declspec (dllexport) BOOL CALLBACK fnHRMCom EndlRCommunication 

(int); 
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□ 

////////////////////////////////////////////////////////////////////// 

/////// 
// 

// Communication Texts 
// 

// 

// Communication texts are shown with infrared communication 

process. By default 

// English texts for buttons and message texts are defined. If 

texts need localization, 

/ / the following functions can be used to change communication 

texts before calling 

// communication functions. The text at the end of the following 

defines shows the 

// default text string for each text item. 

// 

#define HRMCOM_TEXT_CANCEL 0 

// Cancel 

#define HRMCOM_TEXT_RETRY 1 

// Retry 

#define HRMCOM_TEXT__READING 2 

// Reading . . . 

#define HRMCOM_TEXT_NOANSWER 3 

// No answer from HR Monitor 

#define HRMCOM_TEXT_ERRORS 4 

// Errors with Connection 

#define HRMCOM_TEXT_STARTING 5 

// Starting Connection... 

#define HRMCOM_TEXT_TITLE 6 

// Infrared Connection 

#define HRMCOM_TEXT_WRITING 7 

// Writing ... 

// 

// To set each communication text, call function 

f nHRMCom_SetComText . 

// For example this call will change internal text for informing 

user about 

// not getting any answers from HR monitor within answer time- 

// 
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// fnHRMCom__SetComText ( HRMCOM JTEXT_NOANSWER, "Ei vastausta 

sykemittarilta") ; 

// 

declspec (dllexport) BOOL CALLBACK fnHRMCom SetComText 

(int, LPTSTR) ; ~ 

// 

// When HRMCOM . DLL is initialized by starting software calling it 



all the communication 

// texts are resetted automatically. To reset all communication 

texts back to English 

// default texts, the following reset function can be used: 

declspec (dllexport) void CALLBACK f nHRMCom_ResetComTexts (void) 

■ 

r 

// 

// NOTE: Title text for Polar UpLink Communication is always "Pol 

ar 

UpLink". 

// 

////////////////////////////////////////////////////////////////////// 

/////// 

□ 

////////////////////////////////////////////////////////////////////// 

/////// 
// 

/ / Reading Exercises Data 
// 

// 

/ / Reading exercises data from HR monitor using IR connection can 

be done by 

/ / sending and answering to each communication message and also b 

y 

calling function, 

// which generates communication dialog and handles all message b 

y 

itself . 

/ / Communication port has to be opened before reading exercises 

from HR monitor. 

// To read all exercises to memory of DLL, use the following 

function: 

// 

declspec (dllexport) BOOL CALLBACK f nHRMCom_ReadExercisesData 
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(HWND, BOOL) ; 
// 

// Parameters: 
// HWND 
/ / BOOL 
(under construction) 
// 

// After all exercises have been read from HR monitor, the basic 

information 

// about each exercise can be read by using the following functio 

n 

f nHRMCom_GetExeFileInf o . 

// Structure POLAR_EXERCISEFILE includes basic information about 

the exercise data 

// file requested. 

// 

typedef struct 
{ 



int iSize; 
Structure size for version control 



// 



int 



iTime ; 



rt 

time of exercise in seconds 

int iDate; 

rt 

date of exercise in yyyymmdd 

int iDuration; 

Duration of exercise in seconds 
BOOL bUSTimeMode; 

mode in exercise 

int iSamplingRate; 

te 

of exercise 

BOOL bDeleted; 

s 

been marked to be deleted 



// Sta 



// Sta 



// 



// Usage of 12h time 

// Sampling ra 



// Exercise ha 



BOOL 



bSpeed; 



// Speed senso 



data available 

BOOL bCadence; 
sensor data available 

BOOL bAltitude; 
sensor data available 

BOOL bPower ; 

r 

data available 



// Cadence 



// Altitude 
// Power senso 
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BOOL blnterval; // Interval da 

ta 

available 

TCHAR szName[9]; // Exercise 

set/profile name used in exercise 

// Max number of characters is 8 + ending zero 

} POLAR_EXERCISEFILE; 

// 

declspec (dllexport) BOOL CALLBACK f nHRMCom_GetExeFileInf o 

(int, POLAR_EXERCISEFILE* ) ; 

// 

// Parameters: 

// int iExercise Parameter for specifyi 

ng 

exercise of which the information will be retrieved 

// POLARJEXERCISEFILE* pef* Address to exercise file 

information data structure 

// 

// Before reading detailed exercise information from HRMCOM . DLL 1 s 

memory, each 

// exercise file have to be analyzed by using the following 

function: 

// 

declspec (dllexport) BOOL CALLBACK f nHRMCom__AnalyzeFile 

(int, int) ; 
// 

// Parameters: 

// int iExercise Parameter for specifying exercise to be analys 

ed 

// int iAction Parameter for specifying the actions t 

o 

be doen for analysed HR file 

// (when used multiple params, us 

e 

OR) 
// 

/ / HRMCOM_PARAM_FILTERHRDATA 

= Filter averaged HR data (sampling rate 5 or 15 seconds) 

// 

Not available yet! 
// 

// After the succesfull analyzing, all the exercise information c 
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an 

be read 

// by using the functions and defines shown in the following 

chapters . 

// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
□ 

/////////////////////////////////////////////////////////// 
// 

// HRM DATA OUTPUT FUNCTIONS 
// 

/////////////////////////////////////////////////////////// 



declspec 

(int) ; 

declspec 

(int) ; 

declspec 

(void) ; 

declspec 

(int, int) 

declspec 

(void) ; 
declspec 



(int, int) 
declspec 



(void) ; 
declspec 



(int, int) 



dllexport) int CALLBACK fnHRMCom_GetRecParam 

// returns recording parameters 
dllexport) BOOL CALLBACK f nHRMCom_GetRecFlags 

// returns recording flags 

dllexport) int CALLBACK f nHRMCom_GetNbrOf HRMSamples 

// returns nbr. of samples 
dllexport) int CALLBACK f nHRMCom__GetHRMSamples 

// returns HR/CC samples 

dllexport) int CALLBACK f nHRMComjGetNbrOf IntTimes 

// returns number of lap times 
dllexport) int CALLBACK f nHRMCom_Get IntTimeData 

// returns lap time data 

dllexport) BOOL CALLBACK f nHRMCom_GetNbrOf SwapTimes 

// returns number of HR limit swaps 
dllexport) int CALLBACK f nHRMComJSetLimitSwapData 

// returns limit swap data 



/////////////////////////////////////////////////////////// 
// 

// HRM DATA FLAGS 
// 

// Get these parameters by using function: fnHRMCom GetRecFlags 

// 

/////////////////////////////////////////////////////////// 



#def ine 



FLAG CYCLO DATA 



// TRUE, cycling data 
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#define FLAG_3LIMITS_IN_USE 6 

// three HR limits has been used 

#define FLAG_SPEED_DATA 8 

// file has speed data 

#define FLAG_ALT_DATA 9 

// file has altitude data 

#define FLAG_CAD_DATA 10 

// file has cadence data 

#define FLAG_POWER_DATA 11 

// file has power data 

#define FL A G_ I N T E R V AL__ DATA 12 

// file has interval data 

#define FLAG_LAP_DATA 13 

// file has lap data 

#define FL A G_L IMS W A P_ DATA 14 

// file has limit swap data 

# define FLAG_POWER_BALANCE 18 

// file has LR balance data 

#define FLAG_POWER_INDEX 19 

» 

// file has pedalling index data 

/////////////////////////////////////////////////////////// 
// 

// HRM DATA GENERAL RECORDING INFORMATION 
// 

// Get these parameters by using function: fnHRMCom GetRecParam 

// 

/////////////////////////////////////////////////////////// 
#define REC_AM_PM 

1 // 0 = AM, 1 = PM 

#define REC_MONITOR_TYPE 5 

// HR Monitor Type 

#define REC_EURO_US_UNITS 8 

// 0 = Euro, 1 = US 
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#define REC_START_DATE 9 

// Exercise start date in yyyymmdd format 

#define REC START TIME 10 



// Exercise start time hh : mm: ss . s/10 in 1/10 of seconds 



#def ine 




REC_REC_LENGTH 




// Duration on 


exercise (in ms) 




#def ine 




REC_SAMPLING_RATE 




// Recording rate 




#def ine 




REC_UPPER_LIMIT 1 




// 0 - 250 


bpm 






#def ine 




REC_LOWE R_L I M I T_l 




// 0 - 250 


bpm 






#def ine 




REC_UPPER_LIMIT_2 




// 0 - 250 


bpm 






#def ine 




REC LOWER LIMIT 2 




// 0 - 250 


bpm 






#def ine 




REC_UPPER_LIMIT_3 




// 0 - 250 


bpm 






#def ine 




REC LOWER LIMIT 3 


■ 


// 0 - 250 


bpm 






#def ine 




REC_AN AE ROB_L I M I T 




// 0 - 250 


bpm 






#def ine 




REC_AEROB_LIMIT 




// 0 - 250 


bpm 






#def ine 




REC TIMER 1 




21 




// 


timer 1 in seconds 


#def ine 




REC TIMER 2 




22 




// 


timer 2 in seconds 


#def ine 




REC TIMER 3 




23 




// 


timer 3 in seconds 


#def ine 




REC MAX HR 




25 




// 


UpperLimit+1 - 250 


#def ine 




REC REST HR 




26 




// 


0 - LowerLimit-1 


#def ine 




REC RR START DELAY 





11 



12 



13 



14 



15 



16 



17 



18 



19 



20 



27 
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// R-R recording start delay 
#de f ine REC_START_SAMPLE 

// 0 - 250 bpm 

#def ine REC_STOP_TIME 

// h'h:mm: ss . s/10 in 1/10 of seconds 
#define REC_STOP_SAMPLE 

// 0 - 250 

#define REC_STOP_SPEED 
// stop speed 

#def ine REC_STOP_CAD 

// stop cadence 

#def ine REC_STOP_ALT 

// stop altitude 

#define RE C_M I N_H RAT E 

// lowest heart rate 

#def ine REC_AVE_HRATE 

// average heart rate 

#def ine REC_MAX_HRATE 

// highest heart rate 

#def ine REC_TRIP_DIST_STOP 

// trip distance at stop 

#define REC_TRIP_CLIMB_STOP 

// trip climb at stop 

#def ine REC_TOT_TIME_STOP 

// total time at stop 

# de f i ne REC_AVG_ALT 

41 // average altitude 
#define REC_MAX_ALT 

42 // maximum altitude 
#define REC_A VG_S PEED 

// average speed 

#define REC MAX SPEED 
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// maximum speed 

#define REC_ODOM_STOP 4 5 

// odometer stop 

#define REC_MIN_SPEED 4 6 

// minimum speed 

#define REC_RECOVERY_TIME 4 7 

#define REC_RECOVERY_HR 4 8 

#define REC_MAX_POWER 7 8 

// Maximum power in watts 

#define REC_AVE_POWER 7 9 

// Average power in watts 

#define REC_CALORIES 80 

// Calory consumption 

#def ine REC_NBR_OF_LIMITS_IN_USE 8 3 

// Nbr. of HR limits in use 

/////////////////////////////////////////////////////////// 
// 

// HRM DATA SAMPLE TYPES 
// 

// Before getting measured values (samples) , get the number of 

samples by using 

// function f nHRMCom_GetNbrOf HRMSamples . After this operation, 

samples can be get 

// by calling function f nHRMCom_GetHRMSamples for example in the 

following way: 

// 

// iTotal = fnHRMCom_GetNbrOf HRMSamples (); 

// 

// for (i =0; i < iTotal; i++) 

// { 

// iHR[i] = fnHRMCom_GetHRMSamples (CC__HRATE, i) ; 

// iSpeed[i] = f nHRMCom_GetHRMSamples (CC_SPEED, i) ; 

// iCad[i] = fnHRMCom GetHRMSamples (CC CAD, i) ; 

// } " 

// 

// Speed and altitude values unit depends of recording parameter 

REC_EURO_US_UNITS . 

// To get the correct units, use for example the following call: 

// 
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// 




// 


} 


// 


else. 


// 


{ 


// 




// 


"} 


// 





hrmcom. txt 



Speed in mph, altitude in feet 



Speed in km/h, altitude in meters 



/////////////////////////////////////////////////////////// 



#def ine 


CC_HRATE 










1 

#def ine 


CC_SPEED 




// 


heart rate values (bpm / 


msec) 


2 

#def ine 


CC_CAD 




// 


speed values (10 * km/h 


/ 10 * 


3 

#def ine 


CC_ALT 




// 


cadence values (rpm) 




4 

#def ine 


CC_POWER 




// 


altitude values (m / ft) 




5 

#def ine 


CC__POWER_ 


BALANCE 


// 


power values (Watts) 


6 


// power 


LR Balance (left%) 








#def ine 


CC__POWER^ 


_INDEX 






7 


// power 


pedalling index 


(%) 









/////////////////////////////////////////////////////////// 
// 

// LAP TIME DATA INFORMATION 
// 

// Before getting lap time data, get the number of laps by using 

// function f nHRMCom_GetNbrOf IntTimes . After this operation, lap 

// information can be get by calling function 
fnHRMCom_GetIntTimeData 

// for example in the following way: 
// 

// iTotal = fnHRMCom GetNbrOf IntTimes (); 
// 

// for (i =0; i < iTotal; i++) 

// { 

// iTime = f nHRMCom_Get IntTimeData (i, INT_INT_TIME) ; 

// iHR = f nHRMCom_GetIntTimeData (i, INT_SAMPLE) ; 

// iSpeed = fnHRMCom_Get IntTimeData (i, INT SPEED); 

// } 
// 
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/////////////////////////////////////////////////////////// 
#clefine INT_INT_TIME 601 

// Lap time in 1/10 seconds 

#define INT_LAP_INTRVAL 603 

// Lap type: 0 = normal lap, 1 = interval 

#define INT_LAP_DI STANCE 604 

// Lap distance in meters / yards 
#define INT_SAMPLE 

607 // Momentary HR, 0 - 250 bpm 

#define INT_MIN_SAMPLE 608 

// Lap's min HR, 0 - 250 bpm 

#define INT_AVE_SAMPLE 60 9 
// Lap's avg HR, 0-250 bpm 

#define INT_MAX_SAMPLE 610 

// Lap's max HR, 0 - 250 bpm 
#define INT_SPEED 

// Momentary speed, 10 * km/h or mph 
#define INT_AVG_SPEED 612 

// Average speed, 10 * km/h or mph 
#def ine INT_CADENCE 

613 // Momentary cadence, 0 - 180 rpm 

#define INT_AVG_CADENCE 614 

// Average cadence, 0 - 180 rpm 

ttdefine INT_ALTITUDE , 615 

// Momentary altitude, (-1000 - 2047) * 10 m / ft 

ttdefine INT_AVG_ALTITUDE 616 

// Average altitude, (-1000 - 2047) * 10 m / ft 
#define INT_POWER 

617 // Momentary power, 0 - 2000 Watts 

#define . INT_MAX_POWER 618 

// Maximum power, 0 - 2000 Watts 

#define INT_AVE_POWER . 619 

// Average power, 0 - 2000 Watts 
#define INT_TEMP 

621 // Momentary temperature, 10 * -100 ■ 
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+100 f C or 1 F (only from S710) 

#define INT_DIST_REC 624 

// Distance recovery, 10 * km or miles 

#define INT__RECOVERY 625 

// Recovery calculation, 0 = No recovery, 1 = Time Recovery, 2 = +HR 
Recovery, 3 = -HR Recovery, 4 = Distance Recovery 
#def ine INT_HR__REC 

626 // HR recovery value, 0 - 3599 seconds 

#define INT_TIME_REC 627 

// Time recovery value, 0 - 240 bpm 

#define INT_LAP_ASCENT 63 6 

// Lap ascent, trip up, m / feet 

////////////////////////////////////////////////////////////////////// 
// 

/////// 
// 

// HR LIMIT SWAPS, indexes for 1 f nHRMCom GetLimitSwapData ' 
// 

////////////////////////////////////////////////////////////////////// 
// 

/////// 

#define LIM_SWAP_TIME 900 

// HR limit swap time 

#define LIM_SWAP_CODE 901 

// HR limit swap code 

//////////////////////// 
//////////////////////// 
// 

// ONLINE RECORDING 
// 

//////////////////////// 
//////////////////////// 

// Online recording is available only with Polar S810 HR monitor. 

To start online recording, 

// function f nHRMCom_Start IRCommunication have to be called with 

parameter HRMCOM_PARAM_ONLINE . 

// Function 1 f nHRMCom_GetOnlineData 1 returns online data samples 
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received from the S810 

// HR monitor or ONLINE_BUFF_EMPTY if there aren't any new onlin 

samples in the buffer. 

// 

// iData = fnHRMCom GetOnlineData (iParam); 

// 

// Parameter 'iParam' is 32-bit integer and it is reserved for 

future use and it should 

// be 0 (zero) now. Return value is 32-bit integer and it is R-R 

value in milliseconds 

// or ONLINE_BUFF_EMPTY if there aren't any new samples in buffe 

// 

/////////////////////////////////////////////////////////// 
#define ONLINE_BUFF_EMPTY -1 

// online buffer is empty 

declspec (dllexport) int CALLBACK f nHRMCom_GetOnlineData 
(int) ; // return online data samples 
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